home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / graphics / mpeg2animv1.3 / archive / rend105.lha / Rend24.doc < prev    next >
Text File  |  1992-12-10  |  45KB  |  1,022 lines
  1. ----------------------------------------------------------------------------
  2.  
  3.  
  4.                 Rend24 - A Batch Image Conversion System
  5.  
  6.                        Written by Thomas Krehbiel
  7.  
  8.                   Copyright © 1991,1992 Thomas Krehbiel
  9.                           All Rights Reserved
  10.  
  11.  
  12. ----------------------------------------------------------------------------
  13.  
  14. NOTE
  15.  
  16.     This documentation assumes a basic familiarity with AmigaDOS and
  17.     the Amiga interface.  If you aren't familiar with the concepts of
  18.     files, directories, gadgets, windows, etc. you should consult your
  19.     "Introduction to the Amiga" manual.  Another excellent source of
  20.     information is your local Amiga users group.
  21.  
  22.  
  23. DISTRIBUTION
  24.  
  25.     Rend24 is being distributed as Shareware.  If you find this program
  26.     useful, please consider sending a donation of $30 or so to the
  27.     author (address given at the end of this document).
  28.  
  29.     There is no longer any difference between the Shareware version
  30.     of Rend24 and the Registered version of Rend24, so you will not
  31.     be getting anything new by sending me a donation.  If you choose
  32.     to send a donation, please state that you already have version
  33.     1.05.
  34.  
  35.     Rend24 may be freely distributed in its original form to any bulletin
  36.     board, network, or through any public domain library collection, so
  37.     long as no fees (beyond reasonable media costs) are charged for such
  38.     distribution.  This product is being distributed "as is", with no
  39.     warranties expressed or implied as to the use or misuse of the
  40.     program.  The author cannot be held responsible for any damages
  41.     resulting from the use of this program.
  42.  
  43.     Note that version 1.05 will very likely be the final release.  If
  44.     you find it lacking features, you may want to consider purchasing
  45.     ImageFX from GVP; it includes a batch processor very similar to
  46.     Rend24 (coincidentally :) and a wealth of image manipulation
  47.     features.
  48.  
  49.  
  50. OOPS!
  51.  
  52.     Previous versions of the Rend24 documentation left out a very
  53.     important statement:
  54.  
  55.     This software is based in part on the work of the Independant JPEG
  56.     Group.
  57.  
  58.     I'd just like to apologize to the Independant JPEG Group for not
  59.     having included this, they deserve full credit for their work in
  60.     bringing this popular compression format to the computer world at
  61.     large.
  62.  
  63.  
  64. CHANGES IN 1.05
  65.  
  66.     AGA support was the biggest priority in this version.  To support the
  67.     new modes and such, a somewhat signficant change had to be made in the
  68.     way that the output format was chosen in the front end.  The one cycle
  69.     gadget was broken into six cycle gadgets... :)
  70.  
  71.     Support for processing frames that do not progress by 1 has been added
  72.     (ie. support for processing every other frame, etc.).
  73.  
  74.     Sorry, 1.05 prefs are not compatible with older versions.  You'll have
  75.     to resave your prefs.
  76.  
  77.  
  78. INTRODUCTION
  79.  
  80.  
  81.     Rend24 was originally written as an excercise in converting
  82.     24-Bit IFF files into displayable resolutions.  At that time,
  83.     I was working with the Toaster's Lightwave 3D often, and without
  84.     the benefit of a single-frame controller, it was somewhat awkward
  85.     getting a displayable animation out of Lightwave.  Lightwave is
  86.     capable of saving each frame it generates as a 24-Bit IFF file;
  87.     hence, an idea was born.
  88.  
  89.     What I needed was a program that would wait around in the
  90.     background while Lightwave generated a frame.  Then, when the
  91.     frame was saved to disk, the program would jump in and convert
  92.     the 24-bit file down to an Amiga-displayable format and pack
  93.     it into an IFF Animation file and return to waiting for the
  94.     next frame.
  95.  
  96.     So I set out to write my own program to do the job.  Along the
  97.     way it has acquired a number of useful features which don't relate
  98.     at all to the original plan.  You can use it to convert GIF
  99.     files to Amiga format.  You can use it to view JPEG files directly.
  100.     You can use it interactively convert VistaPro generated files into
  101.     DCTV animations.  This program does a lot for the money...
  102.  
  103.     Version 1.05 now fully supports the AGA chipset, for rendering to
  104.     the new modes.  It is one of the few programs at this time that
  105.     does.
  106.  
  107.  
  108. CONCEPT
  109.  
  110.     Rend24's purpose is to convert one or more input images into
  111.     individual viewable ILBM images or a single viewable ANIM animation.
  112.     The input images may be 24-bit ILBMs, GIF format images, or even
  113.     JPEG compressed images.  You control the format of the output
  114.     images and/or animations, including the color depth, dithering,
  115.     and size.
  116.  
  117.     Rend24's strength lies in its ability to convert batches of images
  118.     at a time.  You tell Rend24 where to find the input images, how many
  119.     there are, and then sit back and watch it go.
  120.  
  121.  
  122. FEATURES
  123.  
  124.     o Runs under Workbench 1.3, 2.0, and 3.0.
  125.  
  126.     o Generally fast conversion times.
  127.  
  128.     o Supports most standard IFF-ILBM image formats, from 2-color through
  129.       HAM all the way up to 8- and 24-bit.
  130.  
  131.     o Supports reading Compuserve GIF format images directly.
  132.  
  133.     o Supports reading JPEG/JFIF compressed images directly (thanks
  134.       to the Independant JPEG Group).
  135.  
  136.     o Can generate individual pictures or a standard IFF-ANIM Op 5 animation,
  137.       with or without palette locking.
  138.  
  139.     o Supports HAM-E and DCTV format rendering.
  140.  
  141.     o Supports Floyd-Steinberg dithering to increase the number of apparent
  142.       colors.
  143.  
  144.     o Now includes a handy-dandy front-end for CLI-phobes.
  145.  
  146.     o Supports arbitrary scaling of input images.
  147.  
  148.     o Full support of AGA modes (as of 1.05).
  149.  
  150.  
  151. HARDWARE REQUIREMENTS
  152.  
  153.      Rend24 should run on any Amiga with any amount of chip and fast
  154.      memory.  However, due to the nature of 24-bit image manipulation,
  155.      Rend24 can use up quite a bit of memory loading and converting an
  156.      image.  Working with 320x200x24 images I would say you would need
  157.      1Meg minimum.  Working with 768x480x24 images you will probably
  158.      need at least 3Meg of free memory.  Rend24 always uses fast memory
  159.      except for the memory to open the display screen, so chip memory
  160.      should not be a problem.
  161.  
  162.      Rend24 is fully Workbench 2.0 compatible (as of the time of this
  163.      writing, at least).  In fact, it takes advantage of a couple of
  164.      features in 2.0 which make Amiga mode conversion times a tad
  165.      faster.
  166.  
  167.      As of version 1.05, Rend24 also excels under Workbench 3.0.
  168.  
  169.  
  170. INSTALLATION
  171.  
  172.     Rend24 is fairly easy to install.  Simply drag the program icon
  173.     to wherever you would like it to reside.  It doesn't have to be
  174.     in your C: directory (although if you plan to use the program
  175.     from CLI you might want to put it in your command path somewhere).
  176.  
  177.     Certain features of Rend24 require some libraries to be installed
  178.     in your LIBS: directory.  There should be an installation program
  179.     accompanying the main program, which will guide you through
  180.     installing the libraries.  The libraries are:
  181.  
  182.         hame.library        Required for generating HAM-E images.
  183.  
  184.         dctv.library        Required for generating DCTV images.
  185.  
  186.         arp.library         Required under version 1.3 of the
  187.                             operating system to have a file
  188.                             requester available in the front end.
  189.  
  190.     That's it!  That wasn't so hard, was it? :)
  191.  
  192.     An INSTALL script should be included to automate the installation
  193.     process for you.
  194.  
  195.  
  196. RUNNING THE PROGRAM FROM WORKBENCH
  197.  
  198.     Couldn't be easier... simply double click the Rend24 icon and
  199.     in a few seconds a window will appear on your Workbench with
  200.     a whole bunch of gadgets in it.  This is what I call the "Front End"
  201.     window, and is where you tell Rend24 what you want to do in a
  202.     (hopefully) convienient manner.
  203.  
  204.  
  205.     Source Image Pattern
  206.  
  207.         This is where you enter input file(s).  Click in the string gadget
  208.         and just type the full pathname of image you want to convert.
  209.         Or, you can click on the Choose gadget to the right to open a
  210.         file requester where you can choose the input image.
  211.  
  212.         You can specify a standard wildcard pattern for the source image,
  213.         to convert more than